c 



\ ml / 



v • I: 

ADDING INTERSYSTEMS BIOS TO EXISTING CP/M 2.2 ! 

These notes are provided for the user who previously owned a CP/M 2.2 j 
operating system end wish to upgrade to InterSystems' hardware. These people 
may purchase Inter-Systems' BIOS and add it to their present CP/M 2*2* thus 
avoiding the expense of purchasing CP/M 2.2 twice. 

The user should receive the following documentation from InterSystenis 
to assist in the understanding of these notes. 

Notes for using CP/M 2.2 with Intersystems DIGS ver. 3.d 

pico. 1st (tiny bios) 

xbios.lst (bios) 

boot. 1st 

IASM - A Source code assembler 

When purchasing the BIOS only ( not including CP/M 2.2 )» the user 
should receive a diskette with the following files. 

STARTUP.COM 
PICO. SRC 
XB I OS. SRC 
BOOT* SRC 
ISYS.COM 
irOR2.COM 
IA&M*C0M 



These files are explained in the "Notes ..." literature discribed 
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The main purpose of the following discussion is to enable the user to 
correctly place the InterSystems tiny BIOS on the system tracks of _a single 
density diskette to allow a cold boot with InterSystems hardware. This 
is not reallu difficult* but should be done slowly snd csre'fullw to avoid 
hassle ( unless you are one of those software superstar* who translated 
Hamlet into F r 0RTRAN in the third grade )♦ 

The assumptions made here &r& the following? 

1 ♦ You have a Presently operating CP/M 2.2 system. < 2.0 is 
probably acceptable* but no CP/M 1.4 ) 

2* You are familiar with the operation of JfDT.COM ♦ 
3. You have a text editor that you are familiar with* 



I r i i t j. a 1 S y s t e in D e v e 1 o p m e n 1 ? 

The following procedure is easy to explain* The user is going \*J 
to create a CP/M file which contains the CP/M sysgen program plus 
a complete system image modified to be compatible with InterSysteins hardware* 
Then the user" can use this file to write the modified system image directly 
to the system tracks of a new diskette which will be the new system diskette* 
This diskette should allow the user to boot up the InterSystems system. 

1* Generate an initial system image using your own ; V 10UCPM»C0M ♦ 
Choose your favorite system sine* Save the resulting filet 
We will refer to this file as CPMxx.COM * NOTE:: With InterSystems BIOS 
the maximum CP/M system size is £2k* This system si:v:e 
results in a BIOS starting location at F200h* If a system &i;-:e 
any greater is chosen* the main InterSystems BIO'J will overrun 
the top of memory ( FFFFh >♦ 

2* Using your favorite text editor* set the MSIZE cauate in 

PICO* SRC to be 2 greater than the system size generated by the? 
MOvTPM operation. Save this altered PICO which we'll refer 
to as PICOxx.SRC . For example* if you've created a CPM62.COM 
then you will want to set MSIZE ewual to 64* indicating that 
the end of the BIOS must be below 64k in memory , You would then 
save PIC062.SRC* to maintain consistency in notation . 
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3. Similarly to step 2*i edit the MSIZE eauete in XBIOS.SRC 
to match the MSIZE in. PICOxx.SRC . Save this new BIOS 
source as XBIOxx.SRC ( I ASM* SRC will not handle file 
names with more than six characters >♦ 

4. Assemble PICOxx.SRC and XBIOxx.SRC using IASM.COM ♦ To 
invoke IASM.COM observe following example* 

IASM PICOxx <-- assembles PICOxx.SRC and creates PICOxx.HEX 

all on default drive; 

or 

I ft S M P I C x x * A ft ft < -- - a s s e m b 1 e s P I C x x * i> R C a n d c r e a t e s 

p;i:COxx*HEX and PJCOxx .LST a J 1 on 
drive? "ft* * 

The user might prefer to get the .LST file to assist in 
determining the BIOS location for subsicauent steps. 

5* Run the CP/M L0AD.COM program on XBIOxx.HEX to get XBI0xx.COM . 
6« Run DDT.COM on CPMxx.COM * 

7. While in DDT insert and read standard CP/M SYSGEW.COM ♦ 

8, While still in DDT* insert and r&Bd PICOxx.HEX with a bias 
such that PICOxx.HEX will load at lESOht the co< v-ect 'position 

for the BIOS code in the SYSGEN buffer. PICOxx.HEX will , 

normally load at the BIOS location in PICOxx.LST. To compute "Kjf 
the read bias rectuired use the DDT "h" function to find the 
difference between the value of the BIOS location and lESOh. 
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9* While still in DDT* modify the Autoload locations si tnti o*a.uii •.*»•» 

of the CCP image to create an autoload for "STARTUP". To do this 
^ use the DDT "s" function starting at location ?87h < the 7th byte 
of the CCP ) end insert the following data J 

07 53 54 41 52 54 55 50 

This data is the hex number 7 standing for a seven character 
command file name and then the 7 ascii characters of the word 
"STARTUP"* 

10 ♦ Setup InterSystems bootstrap parameters at location 900h* 
The first parameter is the bootstrap load location* This 
should be two bytes which create a pointer to the location 
80h below where the CCP should be loaded to vun. The CCP 
location may be found in PICGxx*LST . For example* one will 
find that the CCP location for CPMA2*C0H is DCOOrw In this 
case the load location will be J)B80h and the corresponding 
bytes will be 80»DB ♦ 

The second parameter is the bootstrap Jump location* This 
should be two bytes which create a pointer to the BIOS 
location* For example? one will find that the FIDS loaction 
for CPM62*C0M is F200h* In this case the corresponding bytes 
will be 00*F2 * 

The next parameters are consecutively J the first boot 
sector on track 0* the last boot sector on track 0* then the 
first and the last boot sectors on track 1* These may simply 
be set to 01*1A*01*1A ♦ 

Therefore * in the case of setting up a CPM62*C0H for a 
64k system* the following bootstrap parameters zv& inserted 
at 900h using the DDT "s" function: 

80 DB 00 F2 01 1A 01 1A 

11* Leave DDT by typing control "C"* Immediately after the system 
reboots save this new SYSGEN image by typing J 

SAME 50 SYSGENxx.COM 

For your reference* this file's internal structure should now 
be as follows* 

(top of BIOS) 

BIOS (from Pl'COxx.HEX) 
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BD0S 
CCP 
987 7* "STARTUP" 

904 01*1A*01*1.A 

902 Boot Jump location 

900 Boot load location 

„ beginning of SYSGEN storage buffer 

SYSGEN* COM 

100 4. beginning of TPA '• . 

1 1 
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12 » Run SYS6ENxx.COM ♦ Using no source disk ( SYSGENxk.COM .'■ ' 
should come up with a preloaded buffer so Just hit return 
for source drive )* put the system on a fresh single 
density? single sided diskette* 

13. Using PIP.COM> move XBI0kx.COM over to the new diskette 

renaming it to STARTUP.COM . It might also he eonvieruent 

at this time to move the rest of the files (except STARTUP.COM) 

from the InterSystems BIOS diskette to the new diskette. 

The new diskette should now he your first new system diskette. 

•14 ♦ At this point the user should assemble the InterSystems 
hardware into the system. The system should be able to 
boot up off of the new diskette after reset and run. 

With the system up &n6 running on InterSystems hardware?? the 
user should be able to propagate the new system using ISYS.C0M instead 
of SYS6EN.COM . ISYS.C0M will adjust the bootstrap parameter &res to 
accomodate single or double density. IF0R2.COM can be used to create 
new single or double density diskettes * as well as double density * 
double sided. 

If the system will not boot up and the system hardware setup 
has been double checked for problems* then the user might find it 
helpful to go back to the original system and use SYS6ELN.COM to 
read back the system tracks from the new diskette. If the memory 
image is saved immediately after warm boot by typing 

SAVE 50 OBSERVE 
then the user may DDT the file "OBSERVE-." to see what was placed on 
the system tracks of the new diskette. This file should be identic* J to 
the previously created file SYS6ENxx.COM »' If not* repeat the 
procedure more carefully. If it is identical* a correct system 
i.m-;ge» is indicated and more attention should be placed on problems 
with the hardware setup. 

Running the new BIOS with your CP/M 2.2 

Once the new system is running* the user may follow the 
"Notes for using CP/M 2.2 with InterSystems BIOS ver. 3.d" with 
o n e e x c e p t i o n ♦ 

The exception concerns system relocation* the last section 
of the notes. The user who has added the InterSystems BIOS to their 
own previously owned CP/M 2.2 will not receive InterSystems modified 
M0VCPM.COM file. The modified M0VCPM.COM contains a relocatable 
image of PICO* CCP "STARTUP" code* and relocating bootstrap load 
and Jump vectors. These features will not be found in the users previously 
owned M0VCPM.COM ♦ Therefore* when the user wishes to relocate the 
system* they must install these features during the relocating process. 
This is done in a similar manner to what is described above as "Initial 
System Development*. The only difference is that ISYS.C0M should be 
used instead of SYS6EN.COM . The sysgen buffer for ISYS.C0M starts at 
JOOOh instead of 900h and all system image manipulations should reflect 
this offset, For instance* the CPMxx.C0M will nei^ti to be loaded with 
a 70 Oh offset instead of no offset* The CCP will be found st 1080h ins toad 
of 9 8 Oh*, and the BIOS will be located st 2680h instead of H80h. 
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ERRATA FOR CP/M AND BIOS NOTES 

fj "Adding InterSystems BIOS to Existing CP/M 2.2" has the following mistakes: 

1. Page 2 number 8 should have you insert and read PICOxx. HEX with a bias 
such that PICOxx.HEX will load at 1F80HEX , and 

2. The map on page 3 number 11 should be amended to show the bottom of the 

BIOS at 1F80HEX. 
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